PATHMac OS 8 Developer Documentation > Networking and Communications > AppleShare >

User Authentication Modules

OpenSession Callback

Opens a session at the specified address.



 
pascal OSStatus OpenSession(OTAddress *, 

                     const char* endpointString,

                     UAMMessagePtr message);

OTAddress: Address of the server.
endpointString: The endpoint string for the connection. To specify the default endpoint string, set endpointString to nil . The endpoint string provides a way to specify streams configuration information on a per-connection basis. It is only used for TCP/IP connections and is ignored for AppleTalk connections.
message: Pointer to a UAMMessage structure.

DISCUSSION

The OpenSession callback routine opens a session at the address specified by OTAddress . The value of the commandCode field in the UAMMessage structure must be kOpenRequest . The session reference number for the opened session is returned in the sessionRefNum the UAMMessage structure.

For sessions over AppleTalk, the size of cmdBuffer is limited to kMaxAFPCommand (576 bytes), cmdBuffer must be afplogin , and the endpointString parameter is ignored.

For synchronous operation, set the completion and contextPtr fields of the UAMMessage structure to nil . For asynchronous operation, set the completion field of the UAMMessage structure to point to your completion routine and set the contextPtr field to a value that identifies this request.